package com.ruoyi.system.service;

import java.util.List;
import com.ruoyi.system.domain.SysWhitePaperKnowledgeBase;
import com.ruoyi.system.fastgpt.vo.FastGptFileContentRespVO;
import com.ruoyi.system.fastgpt.vo.FastGptFileDetailRespVO;
import com.ruoyi.system.fastgpt.vo.FastGptFileListRespVO;
import com.ruoyi.system.fastgpt.vo.FastGptFileUrlRespVO;

/**
 * 白皮书知识库Service接口
 *
 * @author ruoyi
 * @date 2025-10-25
 */
public interface ISysWhitePaperKnowledgeBaseService
{

    /**
     * 查询知识库列表
     */
    public List<FastGptFileListRespVO> listFastGptFile();

    /**
     * 获取单个文件内容（文本内容或访问链接）
     */
    public FastGptFileContentRespVO getFastGptFileContent(Long id);

    /**
     * FastGPT API文件库获取单个文件阅读链接（用于查看原文）
     */
    public FastGptFileUrlRespVO getFastGptFileUrl(Long id);

    /**
     * FastGPT API文件库获取单个文件详细信息
     * @return
     */
    public FastGptFileDetailRespVO getFastGptFileDetail(Long id);


    /**
     * 查询白皮书知识库
     *
     * @param id 白皮书知识库主键
     * @return 白皮书知识库
     */
    public SysWhitePaperKnowledgeBase selectSysWhitePaperKnowledgeBaseById(Long id);

    /**
     * 查询白皮书知识库列表
     *
     * @param sysWhitePaperKnowledgeBase 白皮书知识库
     * @return 白皮书知识库集合
     */
    public List<SysWhitePaperKnowledgeBase> selectSysWhitePaperKnowledgeBaseList(SysWhitePaperKnowledgeBase sysWhitePaperKnowledgeBase);

    /**
     * 新增白皮书知识库
     *
     * @param sysWhitePaperKnowledgeBase 白皮书知识库
     * @return 结果
     */
    public int insertSysWhitePaperKnowledgeBase(SysWhitePaperKnowledgeBase sysWhitePaperKnowledgeBase);

    /**
     * 批量新增白皮书知识库
     */
    public void batchInsertSysWhitePaperKnowledgeBase(List<SysWhitePaperKnowledgeBase> whitePaperKnowledgeBaseList);

    /**
     * 修改白皮书知识库
     *
     * @param sysWhitePaperKnowledgeBase 白皮书知识库
     * @return 结果
     */
    public int updateSysWhitePaperKnowledgeBase(SysWhitePaperKnowledgeBase sysWhitePaperKnowledgeBase);

    /**
     * 批量删除白皮书知识库
     *
     * @param ids 需要删除的白皮书知识库主键集合
     * @return 结果
     */
    public int deleteSysWhitePaperKnowledgeBaseByIds(Long[] ids);

    /**
     * 删除白皮书知识库信息
     *
     * @param id 白皮书知识库主键
     * @return 结果
     */
    public int deleteSysWhitePaperKnowledgeBaseById(Long id);

    /**
     * 根据项目ID删除白皮书知识库信息
     */
    public int deleteSysWhitePaperKnowledgeBaseByProjectId(Long projectId);
}
